“capIt” is an external function (“XFCN”) for HyperCard or SuperCard that converts the first character or all characters in a word to upper- or lowercase. The word can be of any length, and in the form of any valid HyperTalk or SuperTalk container. (As for HyperTalk or SuperTalk, capIt understands a “word” to be a string of characters delimited by spaces.)
SYNTAX
The syntax of capIt is illustrated in boldface above this scrolling field. capIt usually takes three parameters. The first parameter is the string to be converted. The second parameter determines the direction of the conversion: “upper” means that lowercase letters will be converted to uppercase; “lower” means that uppercase letters will be converted to lowercase. The third parameter determines the extent of the conversion: “all” means that all letters in the string will be converted; “first” means that only the first character will be converted. Values for the second and third parameters must be enclosed with straight quotes (as must the string to be converted, if it is not in a container). These parameters may be abbreviated with only their first character (“u” = “upper”, “a” = “all”, etc.) If the second and third parameters are not given, capIt will default to an “upper”/“first” value, and will capitalize the first character of the string.
If you pass "?" to capIt, it will return a string illustrating proper syntax.
capIt does some rudimentary checking of the parameters you pass to it. If the number or format of parameters is incorrect, capIt will return unchanged the string passed to it.
You can experiment with the effects of capIt syntax by entering a string in the “Input string” field, above right, clicking on the parameter radio buttons below that field, and then clicking on the “capIt” button.
A larger version of the capIt stack that will perform the installation for you should be available from the same source (electronic network, users’ group, etc.) where you obtained this stack.
You may distribute copies of this stack freely—I encourage you to do so—but you may not distribute without my express permission any version of the stack that has been changed in any way by you. You may NOT sell capIt, offer it for sale, or bundle it with other products offered for sale, without my express permission.
Online services, such as CompuServe, GEnie, CONNECT, UseNet, etc., and electronic bulletin boards which charge a fee for membership but not for each download, are exempt from this “sale” prohibition, as are all non-profit Macintosh User Groups which hold regularly scheduled public meetings.
If you desire to include capIt in a collection of software for which you plan to charge others a fee for distribution (i.e., if you wish to include capIt in a commercially distributed collection of shareware and public domain software), you MUST have my express permission before doing so.
If you find a use for capIt, if you discover a bug or want to suggest an enhancement, I’d appreciate hearing from you. Please send me a postcard or pop me an e-mail message.
 (January 1993).iso/Files/Hyper/C-Cl/capIt XFCN No install.cpt/capIt XFCN.No installer/card_3591_render.png){kind=link}
 (January 1993).iso/Files/Hyper/C-Cl/capIt XFCN No install.cpt/capIt XFCN.No installer/card_4747_render.png){kind=link}